Bentley OpenUtilities CONNECT Edition Help

Selecting Scheduling Preferences for Job Types

The Job Type Preferences dialog box is used to control scheduling settings for a job type. This dialog box is accessed with the Preferences > Job Type command on the File menu.

The scheduling settings for a job type determine the conditions under which jobs of this job type can be run. These settings include the following:

  • Enable Scheduling (whether jobs of this job type are to be processed)
  • Default Priority (which job types are to be processed first when several jobs are in line for processing)
  • Run Parameters (whether jobs are to be processed singly or repeatedly)
  • Concurrency Constraints (which jobs are to be processed at the same time)
  • Run Time Constraints (when jobs are to be scheduled for automatic processing)

Enabled and Disabled Scheduling

The Enable Scheduling check box on the Job Type Preferences dialog box determines whether the selected job type will be processed. By default, this setting is active. When scheduling is enabled, the current scheduling preferences will be applied to all jobs of this job type.

Processing of a particular job type can be manually disabled by clearing the Enable Scheduling check box. This allows the administrator to suspend scheduling to correct a problem before the job type generates a failure error.

Bentley OpenUtilities Designer Server can automatically disable scheduling for a job type that cannot be processed successfully. For example, if the GIS becomes unavailable, jobs of the Merge and Post type cannot be processed because the master database cannot be updated. Under these conditions, the first Merge and Post job in the queue will fail and processing will be disabled for subsequent jobs of the Merge and Post type. Once the GIS becomes available, the administrator must reset the Enable Scheduling setting (by selecting the check box) and also rerun the failed job (see “Rerunning Jobs”).

Default Priority

The Default Priority setting on the Job Type Preferences dialog box determines the processing priority for the selected job type. There are three default Priority categories: High, Medium, and Low.

The priority of the job type will automatically determine the priority of all jobs of this job type. However, the priority of selected jobs can be overridden manually. For information about changing the priority of a job, see “Changing the Priority of Jobs”.

To set the default priority of a job type:

  1. From the File menu, point to Preferences and then choose Job Type to open the Job Type Preferences dialog box.
  2. In the Job Type box, select the job type that you want to configure.
  3. Select the Enable Scheduling box
    Note: This check box can be cleared whenever you do not want jobs of this job type to run for a certain period of time.
  4. In the Default Priority box, select a processing priority for this job type and then click Close.

Run Parameters

There are two ways in which jobs of a given job type can be processed: either as a single run or repeatedly at a fixed interval. The Run Parameters settings of the Job Type Preferences dialog box control this aspect of processing.

If you select the Repeating option, you must specify the repeat interval in the Hours, Minutes, and Seconds boxes. This interval is the amount of time that elapses between the completion of a repeating job and the start of its next run.

Bentley OpenUtilities Designer Server processes jobs according to these rules:

  • If multiple jobs (single and repeating) are queued, Bentley OpenUtilities Designer Server identifies the oldest job that has no current time constraints and attempts to run it.
  • If the selected job is a repeating job and is not due for processing (based on the Repeat After interval), the next oldest job is selected and the process repeats.
  • If the selected repeating job can run within a minute, the system sleeps for this interval and then runs the job. If the interval is greater than a minute, the system waits a minute and then repeats the job selection process (in case new jobs have arrived in the queue that can be run sooner, or jobs that previously could not run because of time constraints are now ready for immediate processing.

To set the run parameters of a job type:

  1. From the File menu, point to Preferences and then choose Job Type to open the Job Type Preferences dialog box.
  2. Select the Enable Scheduling box.
  3. Click Single Run or Repeating.
  4. To specify the repeat interval, type a value in the Hours, Minutes, or Seconds box.

Concurrency Constraints

Concurrency constraints refer to the rules that determine which job types may not run at the same time. When many users have the capability to access and manipulate the same GIS data, transactions must be managed so that the data is not corrupted by simultaneous processing.

When Bentley OpenUtilities Designer Server is running, it analyzes which jobs cannot be run concurrently on the basis of their job types and then creates the appropriate number of job dispatchers to accommodate compatible and incompatible jobs.

The Concurrency Constraints dialog box is used to define the concurrency rules of the selected job type. This dialog box opens when you click the Concurrency Constraints button on the Job Type Preferences dialog box.

Adding a job type to the Job Type list makes it incompatible with the currently selected job type and causes its jobs to be run at a different time. Deleting a job type from the list allows jobs of this type to run simultaneously with jobs of the selected job type.

To set the concurrency constraints of a job type:

  1. On the Job Type Preferences dialog box, click Concurrency Constraints to open the Concurrency Constraints dialog box.
  2. To add a job type to the list of concurrency constraints, click Add and select a job type from the drop-down list.
  3. To delete a job type, select the item from the Job Type list and click Delete.
  4. Click Close to save your changes and close the dialog box.

Run Time Constraints

When scheduling is enabled for a job type, the time constraints settings determine when jobs will run—on which day of the week and during what time period.

The Run Time Constraints dialog box is used to set the time constraints for a particular job type. This dialog box is accessed by clicking the Time Constraints button on the Job Type Preferences dialog box.

Clicking the Add button on the Run Time Constraints dialog box creates a default time constraint with the following values:

  • Start Time: 12:00 A.M. (accurate to ± 1 minute)
  • End Time: 12:00 P.M. (accurate to ± 1 minute)
  • Start day: Any Day

Double-clicking a Start Time or End Time value displays a time control for specifying a different numerical value. Double-clicking a Start Day value displays a drop-down list for making a different selection.

To set the time constraints of a job type:

  1. On the Job Type Preferences dialog box, click Time Constraints to open the Run Time Constraints dialog box.
  2. To add a scheduled time to the list of time constraints, click Add. To modify the default Start Time, End Time, and Weekday values, double-click the value to make it editable.
  3. To delete a scheduled time from the list of time constraints, select the item and click Delete.
  4. Click Close to save the changes and close the dialog box.